ZPlay::LoadFileID3Ex Method

Load extended ID3 data from specified file. Only in version 2.00 and above.

C++

bool LoadFileID3Ex(System::String ^ FileName, TStreamFormat Format, TID3InfoEx % Info, bool fDecodePicture);

Parameters

Parameters	Description
System::String ^ FileName	String that specifies the name of the file.
TStreamFormat Format	Stream format. Use sfAutodetect if you need to autodetect stream format of specified file.
TID3InfoEx % Info	Reference to TID3InfoEx receiving extended ID3 data.
bool fDecodePicture	Set to true to decode attached picture. See Remarks section.

Return Values

Return Values	Description
True	All OK.
False	Error. To get error message read here.

Remarks

Check supported formats for info tag support. Some formats can support some sort of "Info tags", but not all.

libZPlay library implements "ID3 tag" interface to different info tags (VORBIS comment, RIFF Info, ...). So, you can retrieve ID3 informations from different streams (mp3, ogg, flac, wav) because library will convert "format specific tag" to ID3 tag info.

Note:

This function can retrieve attached picture from info tag. If you need to draw this picture on screen, set fDecodeEmbededPicture parameter to true to decode attached picture into Bitmap class. See TID3Picture.

Note:

Use this function if you just need ID3 data and you don't need to play this file. This function only loads ID3 data. There is no checking if this is valid file, wave output isn't open ... This function has no effect on currently open file or stream.